home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / cli / ashell.txt < prev    next >
Text File  |  1994-08-27  |  40KB  |  1,057 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                  ASH V0.70
  8.  
  9.                       Copyright (c) 1986,1987 CSL/jdn
  10.  
  11.  
  12. INTRODUCTION:
  13.  
  14. This is Version 0.70 of the ASH document file.  If the program you're using
  15. isn't V0.70 there's a good chance some of the features won't work as
  16. documented in this file.
  17.  
  18. ASH is an acronym for 'A SHell'.  It has some of the features I like best
  19. from the shell I use the most.  This is the only formal documentation for
  20. ASH.  The HELP key also provides a few screens of information that are
  21. helpful if pressed while ASH is running.  That information is contained in
  22. the 'ash.hlp' file.
  23.  
  24. ASH is shareware and you're welcome to copy it and pass it along to as many
  25. people as you want.  Please include the copyright notice above in all
  26. associated files.  To contact me about ASH use the following address:
  27.  
  28.                            CSL, ATTN: ASH
  29.                            Jerry Nowlin
  30.                            318 N. Center Street
  31.                            Plano, IL  60545
  32.  
  33. ASH may never be really 'finished' so any and all comments are welcome.
  34. It's something that some of us (me), who prefer typing to clicking, needed
  35. to be productive.  It isn't perfect so please report any problems.  If you
  36. like ASH, you can report that too.  If you like it enough to use it on a
  37. regular basis please send along a few bucks.  This will put your name on
  38. the registered ASH user list and will enable me to notify you of any major
  39. bug fixes or new releases.  It will also help my wife appreciate the hours
  40. I spend in front of my ST.
  41.  
  42.                                  CONTENTS
  43.  
  44. INTRODUCTION  ........................................................   1
  45. QUICK COMMANDS  ......................................................   2
  46. BUILT-IN COMMANDS  ...................................................   4
  47. COMMAND HISTORY  .....................................................   8
  48. HISTORY EDIT COMMANDS  ...............................................   8
  49. I/O REDIRECTION  .....................................................  11
  50. COMMAND LINES  .......................................................  11
  51. SET VARIABLES  .......................................................  12
  52. ASH INITIALIZATION  ..................................................  13
  53. COMMAND SELECTION  ...................................................  13
  54. ASH SCRIPTS  .........................................................  14
  55. LIMITATIONS  .........................................................  14
  56. MISCELLANEOUS  .......................................................  15
  57. V0.70 NOTES  .........................................................  15
  58.  
  59.  
  60.  
  61.  
  62.                                    - 1 -
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                  ASH V0.70
  71.  
  72.  
  73.  
  74. QUICK COMMANDS:
  75.  
  76. The following list describes the ASH quick or single keystroke commands.
  77. NOTE: these commands DO NOT go into the command history buffer.
  78.  
  79. ESC       The escape key (ESC) puts ASH into history edit mode.  In this
  80.           mode the current command line can be edited or previous commands
  81.           in the history buffer can be pulled back and edited.  The editing
  82.           commands are explained in a later section of this document.
  83.  
  84. ^L        The control-L key (^L) will cause a listing of the command
  85.           history buffer to be displayed on the screen.  There can be up to
  86.           23 command lines in the history buffer.  The number preceding a
  87.           command line in the history buffer can be used with the ^R
  88.           command (see below) to repeat execution of the line.
  89.  
  90. ^R [n-m]  The control-R (^R) key will cause either the previous command
  91.           line, the 'n'th command line or the 'n'th through 'm'th command
  92.           lines to be re-executed.  Unlike the other quick commands, a ^R
  93.           has to be followed by a carriage return.  Due to the way the
  94.           history buffer is numbered, a sequence of command lines can be
  95.           repeated by repeating ^R's with the same value of 'n'.  For
  96.           example, in the develop/debug cycle for the Icon language you
  97.           edit, translate and execute.  The beginning of the history
  98.           listing generated with a ^L might look like this:
  99.  
  100.                     history list:
  101.                       1 - iconx mortgage loan.dat
  102.                       2 - icont mortgage.icn
  103.                       3 - vix mortgage.icn
  104.                     ...
  105.  
  106.           To repeat these three steps after completing the first cycle you
  107.           just keep invoking ^R with an 'n' of 3.
  108.  
  109.           An alternative method would be to invoke ^R with the range '3-1'.
  110.           This would automatically execute command lines 3 through 1 in
  111.           that order.  Due to the way command lines are numbered in
  112.           history, the high number in a range should be first if you want
  113.           the commands to be executed in the same order as they were
  114.           originally.  If you want the commands to execute in reverse order
  115.           you can use '1-3'.  Both orders are acceptable as long as the
  116.           history numbers in the range are valid.
  117.  
  118. ^W        The control-W (^W) key causes a what and who message about ASH to
  119.           be displayed on the screen.  This information is similar to the
  120.           initial section of this document.
  121.  
  122. ^P        The control-P (^P) key causes the prompt to toggle back and forth
  123.           between simply displaying the current drive and displaying the
  124.           current drive and the current directory path.  For example if you
  125.  
  126.  
  127.  
  128.                                    - 2 -
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                  ASH V0.70
  137.  
  138.  
  139.  
  140.           were in the AUTO folder on drive A you could toggle your prompt
  141.           back and forth between:
  142.  
  143.                     [A:\AUTO]
  144.  
  145.           and
  146.  
  147.                     [A:]
  148.  
  149.           The default is to display the drive and path.
  150.  
  151. ^V        The control-V (^V) key makes the cursor visible.  Some programs
  152.           that can be invoked from ASH cause the cursor to become
  153.           invisible.  For instance MicroEMACS 3.7 and ASH itself assume
  154.           you're going back to the desktop when they exit so the cursor is
  155.           turned off.  The ^V is a simple way to make it reappear.
  156.  
  157. BS/^H     The backspace and control-H (^H) keys will cause the last
  158.           character typed to be erased.
  159.  
  160. ^X/^U     The control-X (^X) and the control-U (^U) keys will cause the
  161.           line currently being typed to be aborted.  The aborted command
  162.           will NOT be included in the history buffer.
  163.  
  164. ^C        The control-C (^C) key will SOMETIMES cause the current running
  165.           command or program to abort.  This doesn't always work and
  166.           repeated ^C's will sometimes cause ASH itself to abort.  When a
  167.           program does abort its exit code is frequently munged into a
  168.           GEMDOS error that causes the 'Invalid Function' message to be
  169.           printed.  ASH scripts can be aborted by typing a ^C after a pause
  170.           command has suspended a script.
  171.  
  172. ^D/^Z     The control-D (^D) and the control-Z (^Z) keys will cause ASH to
  173.           exit to the desktop fast with no looking back.
  174.  
  175. UNDO      The UNDO key will cause ASH to ask the user if they want to exit
  176.           to the desktop.  A 'y' will cause the program to exit.  Any other
  177.           character will abort the exit.
  178.  
  179. CLR/HOME  The CLR/HOME key will clear the screen and move the cursor to the
  180.           upper left corner of the screen.
  181.  
  182. HELP      The HELP key will cause one of two different help messages to be
  183.           displayed.  When in normal command mode a summary of the quick
  184.           and the built-in commands is displayed.  When in the history edit
  185.           mode a list of the history editing commands is displayed.
  186.  
  187. Any other control characters typed to ASH are considered an error.  You'll
  188. be beeped and the character will be ignored.  In addition TAB characters
  189. (^I) typed as part of an ASH command line are automatically changed to
  190. spaces.
  191.  
  192.  
  193.  
  194.                                    - 3 -
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.